[docs] improve docs for gtk_accelerator_parse().

Link to gdk_keyval_from_name() and give example for non obvious accelerator
strings.

diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c
index d5d9b53a96e76f526f91198bd08acb3a98bd0ad3..9dbab6f58604e2a6e9128ff37c6d2ba594014c11 100644 (file)
--- a/gtk/gtkaccelgroup.c
+++ b/gtk/gtkaccelgroup.c
@@ -1131,6 +1131,9 @@ is_hyper (const gchar *string)
  * "<Release>z" (the last one is for key release).
  * The parser is fairly liberal and allows lower or upper case,
  * and also abbreviations such as "<Ctl>" and "<Ctrl>".
+ * Key names are parsed using gdk_keyval_from_name(). For character keys the
+ * name is not the symbol, but the lowercase name, e.g. one would use
+ * "<Ctrl>minus" instead of "<Ctrl>-".
  *
  * If the parse fails, @accelerator_key and @accelerator_mods will
  * be set to 0 (zero).